Connect to Mart

If you are using erwin® Data Modeler Workgroup Edition, you connect to the Mart to access models and perform administrative functions.

The way erwin® Data Modeler connects to the Mart has been redesigned now. In the previous versions, erwin® Data Modeler would connect to the Mart (database) server directly. Now, erwin® Data Modeler connects to the Mart through a web server. You can connect multiple instances of erwin DM to the Mart from your computer.

From erwin Data Modeler (DM) and erwin Mart Server (MS) 2019R1 onward, while connecting to erwin MS from erwin DM, version validation has been implemented as follows:

  1. Connecting from erwin DM 2019R1 to erwin MS lower than 2019R1 is not allowed.
  2. Connecting from erwin DM lower than 2019R1 to erwin MS 2019R1 is not allowed.

At the time of logging on to Mart, you must provide the details about the web server and the Mart.

Follow these steps:

  1. Click MartConnect on the toolbar, or on the ribbon, click Mart > Connect.

    The Connect to Mart dialog opens.

  2. Complete the following fields:
    Server Name

    Defines the name of the web server where you have installed the Mart.

    Port

    Specifies the port number to access the web server.

    Default: 18170

    Use IIS

    Specifies that you want to use the IIS web server to connect to Mart. This check box is enabled only if you have configured IIS. For more information about configuring IIS, see the Implementation Guide (Workgroup Edition).

    If you use IIS, open server.xml file available at C:\Program Files\erwin\Mart Server r9\Tomcat64\conf and un-comment <Connector port="8009" protocol="AJP/1.3" allowedRequestAttributesPattern=".*" redirectPort="8443" secretRequired="false"/>.

    IIS Port

    Specify the IIS port number that you want to use. This field is enabled only if you select the Use IIS check box. The default is 80.

    Use SSL

    Specifies that you want to connect to the Mart through a secured connection. SSL lets you access the Mart through a secured connection. This check box is enabled only if you have configured SSL on your web server. For more information about configuring SSL, see the Implementation Guide (Workgroup Edition).

    If you use IIS with SSL, open server_ssl.xml file, which is available at C:\Program Files\erwin\Mart Server r9\Tomcat64\conf and un-comment Connector port="8009" protocol="AJP/1.3" allowedRequestAttributesPattern=".*" redirectPort="8443" secretRequired="false"/>.

    Application Name

    Defines the application name of the Mart that you want to connect to.

    Default: MartServer

    Authentication

    Specifies the type of authentication you want to use. You can use a user name that is authenticated either by the Mart Server application or by Windows.

    User Name

    Defines the name of the user that has access to the Mart. If you are using a Windows-authenticated user name, enter it in the <domain name>/<user name> format.

    A local Windows user who does not belong to a domain or who is not part of an Active Directory cannot log in to the Mart as a Windows user.

    Password

    Defines the password of the user.

    A password should fulfill the following criteria:

    • Contains at least 1 lowercase character

    • Contains at least 1 uppercase character

    • Contains at least 1 number

    • Is minimum 6 characters in length

    • Is maximum 130 characters in length

    Apart from the above criteria, special characters are optional.

    Also, if you enter an incorrect password five consecutive times, your account will be locked for five minutes (300 seconds) by default.
    You can change the time for which the account stays locked as follows:

    1. From Windows Start menu, click All Programs, erwin, Mart Server 12.0 , Configure MartServer.

      The erwin Mart Configuration dialog appears.

    2. On the Mart Administrator tab, edit the value of the Account Lockout Duration (Seconds) field to an appropriate value. At the most, you can set it to 30 days (2592000 seconds).
  3. Click Connect.

    If you have selected Use SSL and the security certificate is installed, you are connected to the Mart.

    After you connect to the Mart, if you click Connect to Model Manager again, a dialog opens seeking your permission to disconnect from the Mart.

    If your security certificate is not installed, a message, The certificate authority is invalid or incorrect, appears. You must install the security certificate to proceed.

    1. Click OK on the message.

      The SSL Certificate Install dialog appears.

    2. Click Install.

      The Certificate dialog appears.

    3. Click Install Certificate.

      The Certificate Import Wizard dialog appears.

    4. Click Next.
    5. Click the Place all certificates in the following store option button and click Browse.
    6. In the Select Certificate Store dialog, select Trusted Root Certification Authorities and click OK.
    7. Click Finish.

      The security certificate is installed and you are connected to the Mart.

More information:

Mart Architecture

Disconnect from Mart

SSL Security Certificate

If your Mart is SSL security-enabled, you must install the security certificate, when you access the Mart for the first time. The System Administrator creates the security certificate while implementing SSL. Install the certificate on every computer that you use to connect to the Mart.

Be sure to install the certificate under the Trusted Root Certification Authorities certificate store.